{{tag>Lucid entreprise BROUILLON}}
----
 
====== Jenkins ======
 
[[wpfr>Jenkins_(informatique)|Jenkins]] est un serveur d'intégration continue très en vogue, notamment pour les projets Java développés avec [[:maven|maven]], développé sous les licences MIT et Creative Commons [[wpfr>Creative_Commons|CC-BY-SA]]. Il s'appelait originellement [[wpfr>Hudson_(informatique)|Hudson]], mais a été renommé suite à un différent entre Oracle, société détentrice du nom, et la communauté open-source.
 
===== Pré-requis =====
 
  * Disposer des [[:sudo|droits d'administration]].
  * Disposer d'une connexion à Internet configurée et activée.
 
===== Installation =====

==== Par les dépôts ====

  * [[:tutoriel:comment_modifier_sources_maj#methode_automatisee_recommande|Installez la clé de dépôt]] <code>http://pkg.jenkins-ci.org/debian/jenkins-ci.org.key</code>
  * [[:tutoriel:comment_modifier_sources_maj#modifier_le_fichier_des_sources|Ajoutez la source de mise à jour]] <code>deb http://pkg.jenkins-ci.org/debian binary/</code>
  * [[:tutoriel:comment_modifier_sources_maj#recharger_la_liste_des_paquets|Rechargez la liste des paquets]] 
  * [[:tutoriel:comment_installer_un_paquet|Installez le paquet]] [[apt>jenkins]]

==== Dans un container Tomcat ====
Ce logiciel  est également fourni sous forme d'une application web empaquetée dans un fichier war susceptible d'être déployée sur un serveur d'applications [[:tomcat|Tomcat]], dont l'installation est donc un prérequis.
  * [[:tutoriel:comment_installer_un_paquet|Installez]] **[[apt>tomcat6|tomcat]]** si ce n'est déjà fait
  * Rendez vous sur le [[http://jenkins-ci.org/|site de Jenkins]], et cliquez sur "Latest and Greatest". Ceci vous permet de récupérer un fichier jenkins.war.
  * [[:commande_shell#manipulation|Copiez-le]] dans le répertoire **/var/lib/tomcat6/webapps**. 
 
===== Configuration =====

Dans le cadre de l'installation sous forme de paquet, il n'y a pas de configuration particulière à effectuer. Dans le cadre d'une installation sous forme de fichier War déployé dans Tomcat, il faut encore effectuer les actions suivantes:
 
  * Tout d'abord, [[:tutoriel:comment_modifier_un_fichier|créez le répertoire]] **/usr/share/tomcat6/jenkins-work** et [[:commande_shell#modification_des_droits_d_acces_proprietes_et_modes|attribuez-lui les droits et groupes]] de l'utilisateur tomcat6. 
  * Puis [[:tutoriel:comment_modifier_un_fichier|éditez le fichier]] **/etc/init.d/tomcat6** et vérifiez que le paramètre ''TOMCAT6_SECURITY'' a bien la valeur "no". 
  * Ensuite, [[:tutoriel:comment_modifier_un_fichier|modifiez le fichier]] **/etc/default/tomcat6** et dans la variable ''JAVA_OPTS'', ajoutez l'option ''-DJENKINS_HOME=/usr/share/tomcat6/jenkins-work''
  * Redémarrez enfin Tomcat via la commande:
<code>sudo /etc/init.d/tomcat6 restart</code>

 
===== Utilisation=====
 
Dans votre navigateur internet, accédez à l'url ''http://localhost:8080/jenkins''. Nous n'expliquerons pas ici comment configurer le logiciel sur le plan de l'utilisation dans le cadre de l'intégration continue, mais vous pourrez utilement consulter [[http://linsolas.developpez.com/articles/hudson/|Le tutoriel de Romain Linsolas sur développez.com]].
 
===== Désinstallation =====
 
Pour supprimer cette application, il suffit de [[:tutoriel:comment_modifier_un_fichier#suppression_de_fichier_ou_dossier|supprimer le fichier]] **/var/lib/tomcat6/webapps/jenkins.war**. Si vous souhaitez supprimer également la configuration globale de l'application et le dépôt associé, supprimez aussi le répertoire **/usr/share/tomcat6/jenkins-work**. Pour désinstaller également [[tomcat|Tomcat]] et [[java|openjdk]], reportez-vous aux pages associées.

===== Problèmes connus=====

==== Erreur "AdjunctManager is not installed for this application" ====
Cette erreur est rencontrée par certains utilisateurs avec les versions 1.402 à 1.405 de Jenkins. La seule solution connue à l'heure actuelle est de revenir en [[http://mirrors.jenkins-ci.org/war/1.401/|version 1.401]].

==== Si vous avez une erreur en relation avec un répertoire ''JENKINS_HOME'' qui ne peut pas être créé ==== 
Vérifiez que vous avez bien donné les droits de l'utilisateur tomcat6 au répertoire que vous avez configuré pour servir de répertoire de travail pour Jenkins, et que vous avez bien modifié le fichier /etc/default/tomcat6 en conséquence comme indiqué plus haut.
 
===== Voir aussi =====
 
  * **(en)** [[http://jenkins-ci.org/|Site officiel du logiciel]]
  * **(fr)** [[http://linsolas.developpez.com/articles/hudson/|Tutoriel de Romain Linsolas sur développez.com]]
  * **(fr)** [[http://www.developpez.net/forums/d1007415/general-developpement/conception/usine-logicielle/integration-continue/projet-hudson-change-nom-devient-jenkins/|Historique des démêlés d'Oracle avec la communauté autour d'Hudson]].
 
---

//Contributeurs principaux : [[utilisateurs:aldian|Aldian]].//